"""
函数是组织好的，可重复使用的，用来实现单一，或相关联功能的代码段。

函数能提高应用的模块性，和代码的重复利用率。你已经知道Python提供了许多内建函数，比如print()。但你也可以自己创建函数，这被叫做用户自定义函数。


你可以定义一个由自己想要功能的函数，以下是简单的规则：

    1. 函数代码块以 def 关键词开头，后接函数标识符名称和圆括号 ()。
    2. 任何传入参数和自变量必须放在圆括号中间，圆括号之间可以用于定义参数。
    3. 函数的第一行语句可以选择性地使用文档字符串—用于存放函数说明。
    4. 函数内容以冒号起始，并且缩进。
    5.return [表达式] 结束函数，选择性地返回一个值给调用方。不带表达式的return相当于返回 None。
定义语法：
    def 函数名（参数列表）:
        函数体




可更改(mutable)与不可更改(immutable)对象
    在 python 中，strings, tuples, 和 numbers 是不可更改的对象，而 list,dict 等则是可以修改的对象。

    不可变类型：变量赋值 a=5 后再赋值 a=10，这里实际是新生成一个 int 值对象 10，再让 a 指向它，而 5 被丢弃，不是改变a的值，相当于新生成了a。

    可变类型：变量赋值 la=[1,2,3,4] 后再赋值 la[2]=5 则是将 list la 的第三个元素值更改，本身la没有动，只是其内部的一部分值被修改了。

python 函数的参数传递：

    不可变类型：类似 c++ 的值传递，如 整数 number、字符串 string 、元组tuple 。如fun（a），传递的只是a的值，没有影响a对象本身。比如在 fun（a）内部修改 a 的值，只是修改另一个复制的对象，不会影响 a 本身。

    可变类型：类似 c++ 的引用传递，如 列表list，字典dict。如 fun（la），则是将 la 真正的传过去，修改后fun外部的la也会受影响

python 中一切都是对象，严格意义我们不能说值传递还是引用传递，我们应该说传不可变对象和传可变对象。


"""


# 传不可变对象
def changeint(a):
    return a + 10


b = 2
changeint(b)
print(b)  # 结果是 2


# 可写函数说明
def changeme(alist):
    alist.append([1, 2, 3, 4])
    print("inner: ", alist)
    return


# 调用changeme函数
mylist = [10, 20, 30]
changeme(mylist)
print("outer: ", mylist)

"""
参数
以下是调用函数时可使用的正式参数类型：
    1.必需参数：必需参数须以正确的顺序传入函数。调用时的数量必须和声明时的一样。
    2.关键字参数:关键字参数和函数调用关系紧密，函数调用使用关键字参数来确定传入的参数值。
               使用关键字参数允许函数调用时参数的顺序与声明时不一致，因为 Python 解释器能够用参数名匹配参数值
    3.默认参数:调用函数时，如果没有传递参数，则会使用默认参数。以下实例中如果没有传入 age 参数
    4.不定长参数：你可能需要一个函数能处理比当初声明时更多的参数。这些参数叫做不定长参数，和上述2种参数不同，声明时不会命名
        def functionname([formal_args,] *var_args_tuple ):
            function_suite
            return [expression]

"""


# 必须参数
def numstablefunc(pystr, pynum):
    print(pystr, pynum, sep=" ")
    return


numstablefunc("linzh", 26)


# 关键字参数
def keyworkfunc(name, age):
    print("Name: ", name)
    print("Age: ", age)
    return


keyworkfunc(age=26, name="linzh")


# 默认参数
def defaultfunc(name, age=35):
    print("名字: ", name)
    print("年龄: ", age)
    return


defaultfunc(age=26, name="linzh")
defaultfunc(name="linzh")


# 加了星号（*）的变量名会存放所有未命名的变量参数。如果在函数调用时没有指定参数，它就是一个空元组。我们也可以不向函数传递未命名的变量。
def buildarr(arg1, *vartuple):
    print("Output: ")
    alist = [arg1]
    for var in vartuple:
        alist.append(var)
    return alist


print(buildarr(10))
print(buildarr(70, 60, 50))
